home *** CD-ROM | disk | FTP | other *** search
/ Network CD 2 / Network CD - Volume 2.iso / programs / internet / tcp / server / amitcp_fspd.lha / fspd / fspd.man < prev    next >
Encoding:
Text File  |  1994-05-20  |  6.3 KB  |  150 lines
  1. FSPD(1)                                                   FSPD(1)
  2.  
  3.  
  4. NAME
  5.        fspd, in.fspd - server for the FSP database
  6.  
  7. SYNOPSIS
  8.        fspd [-f configfile]
  9.  
  10.        in.fspd [-f configfile]
  11.  
  12. DESCRIPTION
  13.        fspd  is  the  server  for  an anonymous-ftp style archive
  14.        called FSP. The main features of this service are: connec-
  15.        tion-less model, communication robustness, server resource
  16.        protection, inter-client  protection,  and  user  friendly
  17.        interface.  Please read the INFO file bundled with the FSP
  18.        source for more information.
  19.  
  20.  
  21. OPTIONS
  22.        -f                  May be used to  specify  an  alternate
  23.                            configuration file.
  24.  
  25. FILES
  26.        .OWN.XXXXXXXX       Used  to  indicate  the ownership of a
  27.                            directory.  If this file is present in
  28.                            a directory, the directory is owned by
  29.                            the  machine  whose  inet  number   is
  30.                            XXXXXXXX  when  printed  as an 8-digit
  31.                            hex number.
  32.  
  33.        .README             A text file that is sent to the client
  34.                            when  the  directory is entered giving
  35.                            information about the  directory.   It
  36.                            can  only  be hand created by the site
  37.                            administrator at this time.
  38.  
  39.        .FSP_OK_DEL         Existence of this file in a  directory
  40.                            grants  non-owner machines the permis-
  41.                            sion to delete items from this  direc-
  42.                            tory.
  43.  
  44.        .FSP_OK_ADD         Existence  of this file in a directory
  45.                            grants non-owner machines the  permis-
  46.                            sion to add items to this directory.
  47.  
  48.        .FSP_PRIVATE        Existence  of this file in a directory
  49.                            means that  files  in  that  directory
  50.                            cannot be read, i.e. they are private.
  51.  
  52.        .FSP_OK_MKDIR       Existence of this file in a  directory
  53.                            grants  non-owner machines the permis-
  54.                            sion to  create  subdirectories  under
  55.                            the current directory.
  56.  
  57.        .TXXXXXXXXXXXX      Transient  temporary  file  in the FSP
  58.                            directory  cache  directory  used  for
  59.                            file uploading.
  60.  
  61.        .GXXXXXXXXXXXX      Transient  temporary  file  in the FSP
  62.                            directory used  for  file  downloading
  63.                            through the fgrab command.
  64.  
  65.        .HTAB_DUMP          A  file  created  in the top directory
  66.                            when fspd receives  an  alarm  signal.
  67.                            It  contains  a  listing of the active
  68.                            clients in fspd's client table.
  69.  
  70.        fspd.conf           A file containing control  information
  71.                            about  how  specific  features  of the
  72.                            server are to be used. See  the  exam-
  73.                            ple.conf file for explicit details.
  74.  
  75.        .FSP_CONTENT        File  used to cache directory listing.
  76.                            Such files  are  normally  created  on
  77.                            demand  in  each  directory  that fspd
  78.                            exports.   If  a   .FSP_CONTENT   file
  79.                            exists  in  a  directory,  but  is not
  80.                            writable by the fspd process, then the
  81.                            directory  cannot  be  listed.   If it
  82.                            does not exist and fspd fails  in  its
  83.                            attempt to create a .FSP_CONTENT file,
  84.                            then  fspd  will  create  one  with  a
  85.                            hashed name in a cache directory spec-
  86.                            ified during  compile  time.   Options
  87.                            can  be  set at compile time such that
  88.                            fspd will create a cache file  in  the
  89.                            cache directory even if a .FSP_CONTENT
  90.                            file could have been  created  in  the
  91.                            directory to be listed.
  92.  
  93.  
  94. AMIGA SPECIFICS
  95.      - Files with a ':' in them cannot be accessed, created or
  96.        destroyed. OTHERWISE people could get access your complete
  97.        system.
  98.  
  99.      - The default location for the configuration file is;
  100.         `amitcp:db/fspd.conf'
  101.        Alternative locations can be given with the startup option
  102.        e.g. `fspd -fhome:fsp/myfspd.conf'
  103.  
  104.      - For configuration options, see example.conf file.
  105.  
  106.      - If you want to run the daemon from inetd,
  107.        copy fspd to amitcp:serv/fspd
  108.  
  109.        add to `amitcp:db/services' the following line;
  110.         `fsp    21/udp'
  111.  
  112.        add to `amitcp:db/inetd.conf'
  113.          `fsp dgram udp wait root amitcp:serv/fspd in.fspd'             or
  114.          `fsp dgram udp wait root amitcp:serv/fspd in.fspd -fmydir/fspd.conf'
  115.  
  116.      - If you want to run the daemon stand-alone just copy fspd
  117.        in a directory (amitcp:bin) and add to `amitcp:bin/startnet'
  118.          run <>NIL: amitcp:bin/fspd [-f mydir/fspd.conf]
  119.  
  120.      - fspd has been tested with an Amiga 500/OS2.04 AmiTCP3.0beta,
  121.        and an A3000/OS2.04 AmiTCP2.3.
  122.  
  123. BUGS
  124.        This version still has a few bugs, but it has not GURU'd
  125.        my machine(s) yet. It has also proven to be secure. Most
  126.        obvious bugs/features are:
  127.  
  128.          - When the homedir in fspd.conf ends in ':', permission
  129.            files will not be read. (i.e. you can't create or
  130.            delete files and directories.)
  131.  
  132.          - If your inetd.conf entry for fspd has a space between
  133.            the -f and the filename, it is likely that inetd gets
  134.            confused.
  135.  
  136.          - The amiga version of fgrabcmd doesn't work properly!
  137.            Maybe UNIX fgrab does???
  138.  
  139.          - Those darn soft-links. Sometimes fspd won't traverse
  140.            links across partitions. (actually never does it!)
  141.  
  142.          - I haven't included the sources yet.... :) Sorry too
  143.            little time to sort all that out now. Be happy I
  144.            found some time to update this manual page.
  145.  
  146. AUTHOR
  147.        Definitively, positively not me. I just made it compile on
  148.        my A500 and added some. But if you do want to contact me
  149.        my email address is <jaharkes@cs.vu.nl>.
  150.